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1 A ppendix A 

2 

3 Explanations and Examples of construct of the ORM Grammar 

4 

5 <REMARK-SPEC> ::= REM [<any remarks>] 

6 Explanation: Any line starting with REM is considered a remark 

7 (comment) line and it is ignored. 



8 Examvl e : REM This is a comment 
9 

10 <ORM-INFO> : := [ ; ORMId=<ORMId>] [ ; ORMFile=< f ileName>] 

11 Exvlanation: <ORMId> specifies the Object Relational Mapping id 



12 of a specification. The default <ORMId> is the 

13 string "def aultORMId" . The Object-Relational 

14 Mapping information (metadata) stored in the database 

15 .corresponding to the given <ORMId> is used for 

16 subsequent processing. 

17 An ORMFile specification overrides the mapping 

18 information corresponding to <ORMId>. This is an 

19 easy way to experiment with different mappings before 

20 storing that information permanently in the database. 



21 Example : See < DATABASE- URL > below. 
22 

23 < DATABASE- URL > ::= <regularURL> [<ORM- INFO>] 
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1 Explanation: < DATABASE- URL > consists of the url (uniform resource 



2 locator, which includes database name, user name and 

3 password among other things) of the database to be 

4 connected to, optionally followed by ORM specific 

5 information <ORM__INFO>. <ORM_INFO> is used to 

6 initialize the database with the Object-Relational 

7 Mapping information or to retrieve the Object- 

8 Relational Mapping information from the database. 



9 Examvle: See <DATABASE-SPEC> below. 
10 



11 

12 <ENDDATABASE-SPEC> : : ; 

13 Explanation: This is just a delimiter to signify the end of 

14 <DATABASE - SPEC> 
15 

16 <DATABASE-SPEC> ::= DATABASE < DATABASE- URL > 

17 <ENDDATABASE-SPEC> 

18 Explanation: A < DATABASE -S PEC > specifies the database and the 

19 Object-Relational Mapping (metadata) information to 

20 be used. Please see < DATABASE- URL > above for more 

21 details. 

22 Example: DATABASE j dbc : odbc : sqlpubs ; user=guest; password=hello; 

23 ORMId=pubs01; 
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1 or 



2 DATABASE j dbc : odbc : sqlpubs ; user=guest; password=hello ; 

3 ORMFi le=pubs . j dx ; 

4 The first example specifies the use of Object- 

5 Relational Mapping information stored in the database 

6 corresponding to the ORMId "pubsOl" 

7 The second example specifies that the Object- 

8 Relational Mapping information should be retrieved from 

9 the file pubs. jdx 
10 



11 <PRIMARY-KEY-SPEC> ::= PRIMARY_KEY { <attribName> . . . } 

12 Explanation: A <PRIMARY-KEY-SPEC> identifies the attribute names 



13 whose combined values uniquely identify a particular 

14 object. For a collection object, it specifies the 

15 attributes whose values are the same for all the 

16 objects in the collection. 

17 Examvle: PRIMARY_KEY pub_id 

18 or 

19 PRIMARY_KEY title_id lorange 
20 

21 <REFERENCE-KEY-SPEC> ::= REFERENCE_KEY <ref erenceKeyName> 

22 {<attribName> . . . } 
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1 Explanation: A <REFERENCE-KEY-SPEC> identifies the attribute 

2 names whose combined values uniquely identify a 

3 particular object. This may be an alternate way of 

4 identifying objects of a particular class. 

5 <REFERENCE-KEY-SPEC> is not allowed for collection 

6 classes. 

7 Example: REFERENCE_KEY name fname minit Iname 

8 Here we are defining a reference key "name" consisting 

9 of three attributes - fname, minit and Iname, 
10 

11 <SQLMAP-SPEC> ::= SQLMAP FOR <attribName> 

12 [COLUMN_NAJyiE <columnName>] 

13 [SQLTYPE <sqlType>] 

14 [NULLABLE] 

15 Explanation; Through <SQLMAP-SPEC> , one can refine the mapping of 

16 a class attribute to SQL column in one of the 

17 following ways - use a column name different than the 

18 attribute name, use an SQL data type different than 

19 the default SQL data type for the attribute type, 

20 allow the column to be nullable. Allowing mapping 

21 of an attribute name to a different column name may 

22 be handy if the existing column name is cryptic and 

23 we want a more meaningful attribute name at the class 
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1 definition level. Semantic knowledge of the data 

2 may be used to improve the storage efficiency for an 

3 attribute by specifying a more refined SQL type. 

4 For example, a String attribute (zipCode) may be 

5 mapped to varchar(lO) instead of default 

6 varchar (255) . 

7 Some object-oriented languages like Java 

8 provide facility of reflection whereby the attribute 

9 names for a class and their types may be determined 

10 programmatically . If that is not the case, then a 

11 . <SQLMAP-SPEC> needs to be specified for each 

12 attribute. Otherwise, some default mapping may be 

13 done using reflection facility. 

14 Example: SQLMAP FOR prinfo COLUiy[N_NAME pr_info SQLTYPE text 

15 or 

16 SQLMAP FOR zip SQLTYPE varchar (10) 
17 

18 <RELATIONSHIP-SPEC> ::= RELATIONSHIP < at tribName> 

19 REFERENCES <targetClassName> 

20 {EMBEDDED | [BYVALUE] [REFERENCED_KEY 

21 <ref erencedKeyName>] WITH<attribName> . . .} 

22 Exvlanation: <RELATIONSHIP-SPEC> is used to provide details for a 

23 complex attribute . 
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EMBEDDED keyword means that the value of a complex 
attribute is embedded in a large binary column of the 
same table where rest of the primitive attributes are 
stored. This may be an optimized way for storing a 
referenced object if that referenced object does not 
need to be retrieved in any other context. 
A Non-embedded complex attribute references a regular 
class or a collection class identified by 
<targetClassName> . 

BYVALUE keyword implies that the referenced object 
(may be a collection object) does not have an 
independent existence without the existence of the 
containing object. When a containing object is 
stored, all the objects referenced through its 
BYVALUE complex attributes are also stored in the 
database. If a containing object is deleted, its 
BYVALUE referenced objects should also be deleted. 
<ref erenceKeyName> specifies the name of a reference 
key of the class <targetClassName> . By default, 
referencing is done to the PrimaryKey of the target 
class . 

The list of <attribName> is an ordered enumeration of 

the source attributes in the current class which are 
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used to find the target class objects through the 
reference key. The data types of the source 
attributes should be compatible with the data types 
of the attributes defining the reference key in the 
target class. 

RELATIONSHIP titles REFERENCES ArrayTitie BYVALUE WITH 
pub_id 

RELATIONSHIP job REFERENCES Job REFERENCED_KEY 
PrimaryKey WITH job_id 

The first specification means that the complex 
attribute 'titles' references an object of type 
ArrayTitie (which is a collection (array) of Title 
objects) . The referenced object is contained in the 
current object by value. The attribute pub_id of 
the containing class is used to identify the (default 
primary key of the) referencing object. 
The second example specifies that the complex 
attribute 'job' references an object of class 'Job' 
with the referencing object's attribute 'job_id' which 
should match the primary key attribute of the class 
'Job' . 
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1 

2 <ENDCLASS-SPEC> ::= ; 

3 Expl ana t ion: This is just a delimiter to signify the end of a 

4 <CLASS-SPEC> or a <COLLECTION- CLASS - SPEC> . 
5 

6 <CLASS-SPEC> : := CLASS<className> [TABLE<tableName>] <PRIMARY-KEY-SPEC> 

7 [<REFERENCE-KEY-SPEC> . . . ] 

8 [<SQLMAP> . . . ] 

9 [<RELATIONSHIP-SPEC> . . . ] 

10 <ENDCLASS-SPEC> 

11 Explanation: A <CLASS-SPEC> encapsulates all the Object- 

12 Relational Mapping information about one class. 

13 The <tableName> specifies the name of the relational 

14 table which holds the instances of this class. The 

15 default <tableName> is the same as the <className>. 

16 Other specifications have been explained earlier. 

17 Please note that it is mandatory to specify <PRIiyiARY- 
18- KEY-SPEC> for a class. 

19 Examvle: CLASS Title TABLE titles 

20 PRIMARY_KEY title_id 

21 RELATIONSHIP royscheds REFERENCES ArrayRoySched 

22 BYVALUE WITH 
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title_id 
SQLMAP FOR price SQLTYPE Money 



5 <ORDERBY-SPEC> ::= ORDERBY { <attribName> . . . } 

6 Explanation: An <ORDERBY-SPEC> of a <COLLECTION-CLASS-SPEC> 

7 specifies an ordered list of attributes whose values 

8 are used to sequence the objects in a collection 

9 during retrieval. 

P 

^13 10 Example: ORDERBY ytd_sales title_id 

P 

'1^11 The above specification for the collection class 

sjl2 ArrayTitle means that such a collection of objects (e. 

''£^ 

13 g. in the titles attribute of a Publisher class 

O 

l'=!14 object) should be ordered as per the values of 

%15 ytd_sales and title_id attributes of the Title objects 

16 in the collection. 

17 

18 <COLLECTION-CLASS-SPEC> ::= COLLECT I ON_CLASS <className> 

19 COLLECTION_TYPE {ARRAY | VECTOR} 

20 ELEMENT_CLASS <elementClassName> 

21 [ELEMENT_TABLE <elementTableName>] 

22 <PRIMARY-KEY-SPEC> 
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1 [<ORDERBY-SPEC>] 

2 <ENDCLASS-SPEC> 
3 

4 Explanation: A <COLLECTION-CLASS-SPEC> encapsulates all the 

5 Ob j ect -Relational Mapping information about a 

6 collection class. A collection is actually a 

7 pseudo-class; there may not be an actual ■ class by 

8 that name in the program. 

9 The COLLECTION_TYPE specifies how the objects in the 
'i3l0 collection are combined together - in an array or in 

a vector. 

12 The <elementClassName> specifies the class whose 

M 13 instances form the collection. Even the instances 

■^'=^^14 of a subclass of the <elementClassName> class may 

■'■-15 participate in a collection. 

m 

16 The mandatory <PRIMARY-KEY-SPEC> specifies the 

17 attributes which are the basis for realizing a 

18 collection. The values of these attributes are the 

19 same for all the objects in a collection. 

20 The <elementTableName> specifies the name of the 

21 relational table which holds the instances of the 

22 collection objects. The default table is the same 

23 as the table for <elementClassName> class. 
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1 Other specifications have been explained earlier. 

2 Examvle: COLLECTION_CLASS ArrayRoySched COLLECT I ON_TYPE ARRAY 

3 ELE]yiENT_CLASS 

4 RoySched 

5 PRIMARY_KEY title_id 

6 ORDERBY royalty 



8 

9 <ORM-SPEC> ::= < DATABASE -S PEC > 



10 Any combination of <CLASS-SPEC> 

11 ■ <COLLECTION-CLASS-SPEC>, 

12 . <SEQUENCE-SPEC> and <REI^1ARK-SPEC> 

13 Explanation: An Object-Relational Mapping specification <ORM-SPEC> 

14 consists of < DATABASE -S PEC > followed by any combination 

15 of <CLASS-SPEC>, <COLLECTION-CLASS-SPEC> and <REMARK- 

16 SPEC>. This is what an <ORMFile> contains. The 

17 following example has an ORMId of pubsOl. 

18 This specification is contained in a file (pubs. 

19 jdx) , 

20 Example: DATABASE 

21 j dbc : odbc : sqlpubs ; user=guest ; password=hel lo ; ORMId=pub 

22 sOl 
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REM 

CLASS RoySched TABLE roysched 
PRIMARY_KEY title_id lorange 

COLLECTION_CLASS ArrayRoySched COLLECTION_TYPE ARRAY 

ELEMENT_CLASS RoySched 
PRIMARY_KEY title_id 
ORDERBY royalty 

CLASS Title TABLE titles 
PRIiyiARY_KEY title_id 

RELATIONSHIP royscheds REFERENCES ArrayRoySched 
BYVALUE WITH 

title_id 
SQLMAP FOR price SQLTYPE Money 

COLLECTION_CLASS ArrayTitle COLLECT I ON_TYPE ARRAY 
ELEMENT_CLASS 

Title 
PRIMARY_KEY pub_id 
ORDERBY ytd_sales title_id 
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2 CLASS Publnfo TABLE pub_info 

3 PRIMARY_KEY pub_id 

4 SQLMAP FOR logo SQLTYPE image 

5 SQLMAP FOR prinfo COLUMN_NAME pr_info SQLTYPE text 
6 

7 CLASS Publisher TABLE publishers 

8 PRIMARY_KEY pub_id 



RELATIONSHIP publnfo REFERENCES Publnfo BYVALUE WITH 
pub_id 

RELATIONSHIP titles REFERENCES ArrayTitle BYVALUE 
WITH pub_id 

CLASS Job TABLE jobs 
PRIMARY_KEY job_id 



17 CLASS Emp TABLE employee 

18 PRIMARY_KEY emp_id 

19 RELATIONSHIP job REFERENCES Job REFERENCED_KEY 

20 PrimaryKey WITH 

21 job_id 

22 RELATIONSHIP publisher REFERENCES Publisher WITH 

23 pub_id 
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1 

2 CLASS TitlePub 

3 PRIMARY_KEY title_id 

5 CLASS LinkList TABLE linklist 

6 PRIMARY_KEY link_id 

7 RELATIONSHIP next REFERENCES LinkList BYVALUE WITH 

8 next_link_id 
9 

10 
11 



12 <SEQUENCE-SPEC> : := SEQUENCE <sequenceName> 



13 MAX_INCREMENT <maxIncrementValue> 

14 [START_WITH <startingVal>] 

15 Explanation : A <SEQUENCE-SPEC> defines a sequencer which can 

16 provide chunks of persistently unique sequence 

17 numbers . 

18 <TnaxIncrementValue> is used to do sanity-check 

19 against requests which may erroneously ask for a 

20 large chunk of sequences which may quickly reduce the 

21 availability of new sequence numbers. 

22 Optional <startVal> specifies the starting sequence 

23 number provided through this sequencer. The 
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1 default is 1. 

2 

3 Examvle : SEQUENCE seqFoo MAX_INCREMENT 100 or 

4 SEQUENCE seqBar MAX_INCREMENT 1000 START_WITH 10001 

5 The second sequencer (seqBar) starts with a value of 

6 10001. 
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